home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat2 / standard / cacheflush.z / cacheflush
Encoding:
Text File  |  1998-10-20  |  3.6 KB  |  67 lines
  1.  
  2.  
  3.  
  4. CCCCAAAACCCCHHHHEEEEFFFFLLLLUUUUSSSSHHHH((((2222))))                                                    CCCCAAAACCCCHHHHEEEEFFFFLLLLUUUUSSSSHHHH((((2222))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cacheflush, _flush_cache - flush contents of instruction and/or data
  10.      cache
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ####iiiinnnncccclllluuuuddddeeee <<<<ssssyyyyssss////ccccaaaacccchhhheeeeccccttttllll....hhhh>>>>
  14.  
  15.      iiiinnnntttt ccccaaaacccchhhheeeefffflllluuuusssshhhh ((((vvvvooooiiiidddd ****aaaaddddddddrrrr,,,, iiiinnnntttt nnnnbbbbyyyytttteeeessss,,,, iiiinnnntttt ccccaaaacccchhhheeee))));;;;
  16.  
  17.      iiiinnnntttt ____fffflllluuuusssshhhh____ccccaaaacccchhhheeee ((((cccchhhhaaaarrrr ****aaaaddddddddrrrr,,,, iiiinnnntttt nnnnbbbbyyyytttteeeessss,,,, iiiinnnntttt ccccaaaacccchhhheeee))));;;;
  18.  
  19. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  20.      _c_a_c_h_e_f_l_u_s_h and __f_l_u_s_h__c_a_c_h_e are different names for the same function.
  21.      They flush the contents of the indicated cache(s) for user addresses in
  22.      the range _a_d_d_r to (_a_d_d_r+_n_b_y_t_e_s-1).  The _c_a_c_h_e parameter may be one of:
  23.  
  24.      IIIICCCCAAAACCCCHHHHEEEE           Flush only the instruction cache
  25.  
  26.      DDDDCCCCAAAACCCCHHHHEEEE           Flush only the data cache
  27.  
  28.      BBBBCCCCAAAACCCCHHHHEEEE           Flush both the instruction and the data cache
  29.  
  30. RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  31.      _c_a_c_h_e_f_l_u_s_h and __f_l_u_s_h__c_a_c_h_e return 0 when no errors are detected.  If
  32.      errors are detected, they return -1 with the error cause indicated in
  33.      _e_r_r_n_o.  For IP19, IP21 and IP25, the following describes the action of
  34.      this command on any physical lines corresponding to the input virtual
  35.      address range that may be present in the caches.  On IP19 and IP25,
  36.      DCACHE flushing writes back any dirty data and invalidates the cache line
  37.      in the data and the secondary cache. ICACHE flushing on the IP19 and IP25
  38.      consists of invalidating the line in the icache and the secondary cache.
  39.      Additionally, prior to this, if the line is dirty in the dcache and/or
  40.      secondary, it is written back.  On IP21s, DCACHE flushing is a no op, and
  41.      ICACHE flushing does not affect the gcache directly, but loads in a set
  42.      of different instructions into the icache.  The BCACHE option in all
  43.      cases writes back the lines if they are dirty, and then invalidates them
  44.      if they are present in any of the caches (except for IP21s, where the
  45.      lines are displaced from the icache).
  46.  
  47.  
  48.  
  49. EEEERRRRRRRROOOORRRRSSSS
  50.      [EINVAL]         The _c_a_c_h_e parameter is not one of ICACHE, DCACHE, or
  51.                       BCACHE.
  52.  
  53.      [EFAULT]         Some or all of the address range _a_d_d_r to (_a_d_d_r+_n_b_y_t_e_s-1)
  54.                       is not accessible.
  55.  
  56. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  57.      cachectl(2)
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.